Skip to content

Conversation

blueww
Copy link
Member

@blueww blueww commented Oct 10, 2025

Description

Mandatory Checklist

  • SHOULD update ChangeLog.md file(s) appropriately
    • Update src/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.
      • A snippet outlining the change(s) made in the PR should be written under the ## Upcoming Release header in the past tense.
    • Should not change ChangeLog.md if no new release is required, such as fixing test case only.
  • SHOULD regenerate markdown help files if there is cmdlet API change. Instruction
  • SHOULD have proper test coverage for changes in pull request.
  • SHOULD NOT adjust version of module manually in pull request

@Copilot Copilot AI review requested due to automatic review settings October 10, 2025 08:48
Copy link

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

Copy link

‼️ DO NOT MERGE THIS PR ‼️
This PR was labeled "Do Not Merge" because it contains code change that cannot be merged. Please contact the reviewer for more information.

Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR implements a TSP (TypeSpec) generation SRP (Storage Resource Provider) swagger migration test for Azure PowerShell Storage module. The migration transitions from multiple separate JSON specification files to a single consolidated OpenAPI specification.

Key Changes

  • Updated AutoRest configuration to use consolidated OpenAPI spec from TSP generation
  • Added new Network Security Perimeter Configuration cmdlets and documentation
  • Updated documentation with improved parameter descriptions

Reviewed Changes

Copilot reviewed 21 out of 228 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
README.md Updated input-file configuration to use consolidated OpenAPI spec
generate-info.json Updated generation ID for new build
Properties/AssemblyInfo.cs Incremented assembly version from 9.1.0 to 9.2.0
docs/*.md Added new cmdlet documentation and updated parameter descriptions
test/*.Tests.ps1 Added skeleton test files for new cmdlets
examples/*.md Added placeholder example files for new cmdlets
UX/*.json Added UX metadata for new cmdlets and updated existing configurations
Comments suppressed due to low confidence (1)

### -StartOn
When to start task execution.
This is a required field when ExecutionTrigger.properties.type is 'RunOnce'; this property should not be present when ExecutionTrigger.properties.type is 'OnSchedule'
This is an optional field when ExecutionTrigger.properties.type is 'RunOnce'; this property should not be present when ExecutionTrigger.properties.type is 'OnSchedule'
Copy link

Copilot AI Oct 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The documentation change makes the StartOn field optional for 'RunOnce' type, but this contradicts the logical requirement that a run-once task should specify when to start. Consider reviewing if this change accurately reflects the API behavior or if the original 'required' documentation was correct.

Suggested change
This is an optional field when ExecutionTrigger.properties.type is 'RunOnce'; this property should not be present when ExecutionTrigger.properties.type is 'OnSchedule'
This is a required field when ExecutionTrigger.properties.type is 'RunOnce'; this property should not be present when ExecutionTrigger.properties.type is 'OnSchedule'

Copilot uses AI. Check for mistakes.

Comment on lines +1 to +22
### Example 1: {{ Add title here }}
```powershell
{{ Add code here }}
```

```output
{{ Add output here (remove the output block if the example doesn't have an output) }}
```

{{ Add description here }}

### Example 2: {{ Add title here }}
```powershell
{{ Add code here }}
```

```output
{{ Add output here (remove the output block if the example doesn't have an output) }}
```

{{ Add description here }}

Copy link

Copilot AI Oct 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The example files contain placeholder content with template markers like '{{ Add title here }}' and '{{ Add code here }}'. These need to be replaced with actual, functional examples before release.

Suggested change
### Example 1: {{ Add title here }}
```powershell
{{ Add code here }}
```
```output
{{ Add output here (remove the output block if the example doesn't have an output) }}
```
{{ Add description here }}
### Example 2: {{ Add title here }}
```powershell
{{ Add code here }}
```
```output
{{ Add output here (remove the output block if the example doesn't have an output) }}
```
{{ Add description here }}
### Example 1: Reconcile Network Security Perimeter Configuration for a Storage Account
```powershell
Invoke-AzStorageReconcileNetworkSecurityPerimeterConfiguration `
-ResourceGroupName "MyResourceGroup" `
-AccountName "MyStorageAccount"
Status     : Succeeded
Message    : Network security perimeter configuration reconciled successfully.
ResourceId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Storage/storageAccounts/MyStorageAccount

This example reconciles the network security perimeter configuration for the specified storage account in the given resource group.

Example 2: Reconcile Network Security Perimeter Configuration with Confirmation

Invoke-AzStorageReconcileNetworkSecurityPerimeterConfiguration `
  -ResourceGroupName "MyResourceGroup" `
  -AccountName "MyStorageAccount" `
  -Confirm
Confirm
Are you sure you want to perform this action?
Performing the operation "Reconcile Network Security Perimeter Configuration" on target "MyStorageAccount".
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
Status     : Succeeded
Message    : Network security perimeter configuration reconciled successfully.
ResourceId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Storage/storageAccounts/MyStorageAccount

This example reconciles the network security perimeter configuration for the specified storage account and prompts for confirmation before proceeding.

Copilot uses AI. Check for mistakes.

@blueww blueww marked this pull request as draft October 10, 2025 08:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant